home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / zips12.zip / ZIPSTAMP.DOC < prev    next >
Text File  |  1992-05-15  |  7KB  |  136 lines
  1.  
  2.  
  3.  
  4.                               Zip Stamp Version 1.2
  5.                   A Utility For Adding Comments To Zip Archives
  6.            Copyright (C) 1992 Lightning Software, All Rights Reserved
  7.                        Coded And Written By Robert L. Folmer
  8.  
  9.           ***Bear Cat BBS Home Of Lightning Software (404) 739-1216***
  10.  
  11.           Warranty
  12.           ========
  13.           Zip Stamp 1.2 is distributed without warranty. In no event
  14.           will Lightning Software be liable to you for any damages from
  15.           running this program. Including any loss of profits, lost
  16.           savings, or other incidental or consequential damages arising
  17.           out of your use of or inability to use the program, even if
  18.           Lightning Software or a authorized representative has been
  19.           advised of the possibility of such damages.
  20.           Lightning Software will not be liable for any such claim by
  21.           any other party. All risk associated with using this program
  22.           are the complete responsibility of the user.
  23.  
  24.           Introduction
  25.           ============
  26.           Zip Stamp is a very small and compact program, it allows you to
  27.           comment your zip files, with a simple 1 line comment up to a
  28.           comment size of 20K! It is great for BBS system operators as well
  29.           as it allows you to automatically via a batch file, put a comment
  30.           into a recently uploaded zip file. This is great for advertisements
  31.           and more! It's quick and simple design makes it one of the first
  32.           choices in zip file commenting programs.
  33.  
  34.           Installation
  35.           ============
  36.           Installing Zip Stamp is an extremely easy procedure. It can be
  37.           installed and run from a floppy diskette or a hard disk drive.
  38.           However make sure that where you install it, PKZIP.EXE will be
  39.           accessible either via a PATH statement in your AUTOEXEC.BAT file
  40.           or in the same directory you run the program from. To install
  41.           Zip Stamp on a floppy diskette, simply format a diskette to hold
  42.           the Zip Stamp files, then simply uncompress the archive to the
  43.           newly created diskette. To install Zip Stamp on a system equiped
  44.           with a hard disk drive, simply create a directory to hold all
  45.           Zip Stamp files, then simply uncompress the archive into the newly
  46.           created directory. Now before running Zip Stamp you should use your
  47.           favorite ASCII text editor to edit the file ZIPSTAMP.DAT. This file
  48.           is a straight ASCII text file that contains the comment you would
  49.           like Zip Stamp to add to your zip files. You may edit the one
  50.           supplied or create your own. You should note however, that the
  51.           first line should be left blank, this insures that your text will
  52.           be centered properly. Although it is possible to add an ANSI
  53.           comment using Zip Stamp, it is not recommended as to be able to view
  54.           an ANSI comment you will have to add the -q option while unzipping
  55.           the file, therefore it is best to use a straight ASCII text file.
  56.           That's all there is to installing Zip Stamp! Now to run the program
  57.           simply enter the following command at the DOS prompt.....
  58.  
  59.           ZIPSTAMP [Drive][Full path and name of zip file to be commented]
  60.  
  61.                                        Example.....
  62.  
  63.                             ZIPSTAMP C:\FILES\ZIPSTAMP.ZIP
  64.  
  65.           The above example will comment the file ZIPSTAMP.ZIP located in the
  66.           C:\FILES directory with the ZIPSTAMP.DAT comment.
  67.  
  68.           IMPORTANT! ZIPSTAMP.DAT Must be located in the same directory
  69.           as ZIPSTAMP.EXE or the program will abort!
  70.  
  71.           Using Zip Stamp On A BBS
  72.           ========================
  73.           Using Zip Stamp on a BBS to comment newly uploaded zip files is one
  74.           of the most used aspects of Zip Stamp. Setting up Zip Stamp on a BBS
  75.           is quite easy. First your BBS software must be able to call a batch
  76.           file when an upload completes passing the full path and name of the
  77.           uploaded file to Zip Stamp. This should not be a problem since most
  78.           systems use batch files for testing and scanning a uploaded file
  79.           anyway. A good example of one system that supports the use of a
  80.           upload batch file is TriBBS. Below is an example of a UPLOAD.BAT
  81.           batch file for TriBBS, with most systems the batch file will not
  82.           need much modification from that shown in order to operate properly.
  83.           Simply modify the following batch file for your BBS software.....
  84.  
  85.           ECHO OFF - Sets the DOS echo feature to off
  86.           CD\TRIBBS\ZIPSTAMP - Changes to the ZIPSTAMP directory
  87.           ZIPSTAMP %1 - Runs Zip Stamp and passess the full path and name of
  88.                         the uploaded file to Zip Stamp.
  89.           CD\TRIBBS - Changes back to the TRIBBS directory
  90.  
  91.           Notice that the batch file above does not include a command to reload
  92.           the bulletin board software. This is because TriBBS does not exit
  93.           from memory before running UPLOAD.BAT, so therefore when Zip Stamp
  94.           drops back to the command line, TriBBS will then take control. Some
  95.           software however may require the use of a command to reload the
  96.           system, please see your BBS software manual for information on
  97.           calling batch files.
  98.  
  99.           Zip Stamp cannot comment files other than zip files, note that it is
  100.           OK if your software calls Zip Stamp for a non zip file. PKZIP will
  101.           simply print an error message if this occurs, it does not in anyway
  102.           affect the file or Zip Stamp itself, the program will simply drop
  103.           back to the command line and reload the BBS software as if it had
  104.           just processed a zip file.
  105.  
  106.           Registration
  107.           ============
  108.           Zip Stamp 1.2 is being distributed under the shareware concept,
  109.           you are free to use this product for a period of 30 days after
  110.           which you must either register the program or discontinue it's use.
  111.           Registration is only $5.00, registering Zip Stamp will get rid of
  112.           the # UNREGISTERED!!!! # notices contained in the program. When you
  113.           register Zip Stamp you will receive a registered copy of the
  114.           software on your choice of 3 1/2" or 5 1/4" disk. As well as the
  115.           latest version and lifetime support. To register your copy please
  116.           complete the included form (REGISTER.FRM) and return it to the
  117.           address on the form.
  118.  
  119.           Questions And Or Comments
  120.           =========================
  121.           If you have questions or comments about this or any other
  122.           Lightning Software product, please write to the address below
  123.           or call the Lightning Software support BBS (Bear Cat BBS)
  124.           at (404) 739-1216 24 hours a day.
  125.  
  126.  
  127.                                    Lightning Software
  128.                                    2669 Lantern Trail
  129.                                    Lithia Springs, Ga 30057
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.